home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 5 / QRZ Ham Radio Callsign Database - Volume 5.iso / files / amiga / nosutils.lha / AmigaNOS-Utilities.PRT < prev    next >
Encoding:
Text File  |  1993-12-05  |  10.9 KB  |  292 lines

  1. #1zz
  2.  
  3.  
  4.  
  5.  
  6.  
  7.           AmigaNOS Utilities                               December 5, 1993
  8.  
  9.  
  10.           Legal Mumbo Jumbo:
  11.  
  12.           These AREXX  programs and  documentation are  Copyright   1993 by
  13.           Dan Roman.  Permission is  granted  to  redistribute  and  use or
  14.           modify the same as FREEWARE.  Please credit me if you use my work
  15.           and  I'd  like  to  see  the  results  of   any  improvements  or
  16.           modifications you make.
  17.  
  18.           The only warranty is "It works for me."
  19.  
  20.  
  21.           How to contact the author:
  22.  
  23.           My  amateur  call  sign  is  N2MFC  and  I  can be reached at the
  24.           following addresses (in order of preference):
  25.  
  26.           1) Internet as roman@tix.timeplex.com
  27.           2) or D.ROMAN1@genie.geis.com
  28.           3) GEnie as D.ROMAN1
  29.           4) Amateur radio TCP/IP as n2mfc%n2mfc@w2nv.ampr.org
  30.           5) Amateur radio AX.25 BBS as n2mfc@n2imc.#nnj.nj.usa.na
  31.  
  32.  
  33.           What's in here and what does it do?
  34.  
  35.           Contained in the archive with this documentation you  should find
  36.           the following  files which  pertain to using AmigaNOS for amateur
  37.           radio TCP/IP:
  38.  
  39.           AmigaNOS-Utilities.doc   What you are reading now.
  40.           SendMail.rx              AREXX program to allow  various versions
  41.                                    of ELM to work with AmigaNOS.
  42.           Announcer.rx             A little  gizmo which  allows you to let
  43.                                    people page you or run programs  on your
  44.                                    Amiga by sending mail to your Amiga.
  45.  
  46.           Why did  I choose to use AREXX over C?  First, not everyone has a
  47.           C compiler and AREXX comes standard with the AmigaDOS.   There is
  48.           a  lot  of  room  for  variation from system to system especially
  49.           among amateurs using AmigaNOS, AREXX allows the user to customize
  50.           these routines  for use  with his  specific needs.  Second, AREXX
  51.           allows for very quick development of routines like  these.  Speed
  52.           is not critical and AREXX handles the job quite nicely.  This was
  53.           a nice little job that did not justify  C and  if C  was the only
  54.           way to  do it  I probably  would not have invested the time to do
  55.           it!
  56.  
  57.  
  58.  
  59.  
  60.                                           1
  61. z
  62.  
  63.  
  64.  
  65.  
  66.           AmigaNOS Utilities                               December 5, 1993
  67.  
  68.  
  69.           Setting up SendMail:
  70.  
  71.           The instructions below assume you are using AmigaELM version 1.17
  72.           by      Andreas      M.      Kirchwitz      (Internet     address
  73.           amk@zikzak.in-berlin.de).    There  are  other  version   of  ELM
  74.           available  and  although  none  are  tailored  to  amateur  radio
  75.           specifically and therefore have  many  drawbacks,  this  one does
  76.           work fairly well.
  77.  
  78.           1)   You need  to make the following two aliases which your shell
  79.                running ELM can use:
  80.  
  81.                     alias sendmail rx SendMail.rx
  82.                     alias rmail rx SendMail.rx
  83.  
  84.                AmigaELM  calls  either  sendmail  or  rmail  (depending  on
  85.                whether or  not it  is doing a reply) and feeds it the email
  86.                message from stdin.   Aliasing  the  AREXX  execution allows
  87.                sendmail.rx to take stdin and process it.
  88.  
  89.           2)   You must  have the  assignment for ELM's uumail: pointing to
  90.                your AmigaNOS Spool/Mail directory.
  91.  
  92.           3)   The following  ELM  parameters  should  be  set  in  the ELM
  93.                uulib:Config file.   I  use my  call, N2MFC in all examples.
  94.                ELM parameters which I  have not  listed are  unimportant to
  95.                SendMail.
  96.  
  97.                     NodeName n2mfc
  98.                     UserName n2mfc.txt
  99.                     RealName Dan Roman
  100.                     DomainName  .ampr.org
  101.                     DefaultNode n2mfc
  102.  
  103.           4)   The  following  ELM  parameters  should  be  set  in the ELM
  104.                uulib:.elm/elmrc file.   ELM  parameters  which  I  have not
  105.                listed are unimportant to SendMail.
  106.  
  107.                     SendmailVersion      Feulner
  108.  
  109.           5)   You must  edit two  lines in the beginning of SendMail.rx to
  110.                assign  the  variables  mailhost   and  stationcall.     See
  111.                SendMail.rx for more information.
  112.  
  113.           NOTE:  SendMail uses the T: directory for temporary files.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                           2
  120. z
  121.  
  122.  
  123.  
  124.  
  125.           AmigaNOS Utilities                               December 5, 1993
  126.  
  127.  
  128.           Using SendMail:
  129.  
  130.           When you send or reply to a mail message using ELM, ELM will call
  131.           the SendMail.rx AREXX program.   You  must  however  be  aware of
  132.           several things  in the  use of ELM which affect SendMail.  ELM is
  133.           not 100% clean in these respects.
  134.  
  135.           1)   The To:  line  should  contain  only  one  address, multiple
  136.                addressees  are  not  supported.   SendMail simply passes on
  137.                addressing to AmigaNOS for the  smtp  command  to  use.   It
  138.                creates  files  in  the  AmigaNOS Spool/MQueue directory and
  139.                updates the file sequence.seq as necessary.
  140.  
  141.           2)   Provisions are made within  SendMail to  allow up  to 10 cc:
  142.                address to be placed on one line and 10 bcc: addresses to be
  143.                placed on one line.  Place  these lines  after the  To: line
  144.                and before the Subject: line.  For example:
  145.  
  146.                     To: ron
  147.                     Cc: bill steve ka9q@ucsd.edu
  148.                     bcc: joe john g1yyh@g1yyh.ampr.org
  149.                     Subject: Test of sendmail.
  150.  
  151.                SendMail  creates  individual  files  for  AmigaNOS  smtp to
  152.                process for each recipient.
  153.  
  154.           3)   This has nothing to do with SendMail really but is important
  155.                for using  ELM.   You must leave a blank line in between the
  156.                header information (usually the Subject: line)  and the body
  157.                of the text.  Otherwise, ELM on receiving mail will consider
  158.                part of the body of text  header information  (until a blank
  159.                line is  reached).  This method of implementing ELM for this
  160.                version allows headers to  be  added  easily  and simplified
  161.                coding by  leaving it  up to  the user to design and compose
  162.                the header properly but it  is  not  consistent  with recent
  163.                revisions of ELM (ie 3.4) on Unix workstations.
  164.  
  165.           NOTE:   SendMail does  some processing of header information that
  166.           ELM passes on and adds the date to the header.  SendMail attempts
  167.           to  read   the  TZ  environment  variable  to  get  the  timezone
  168.           information (defaults to GMT).  See SendMail.rx for more details.
  169.  
  170.  
  171.           Setting up Announcer:
  172.  
  173.           1)   Edit  the   variables   mailfile,   modemport,  modemstring,
  174.                modemringdelaybeeperstring,  and beeperdelay  as needed in
  175.                the top of Announcer.rx,  see Announcer.rx  for details.   I
  176.                chose the  user "robot"  for Announcer  to use on my system.
  177.  
  178.                                           3
  179. z
  180.  
  181.  
  182.  
  183.  
  184.           AmigaNOS Utilities                               December 5, 1993
  185.  
  186.  
  187.                Announcer deletes the mail  file after  processing it  so be
  188.                sure you don't use YOUR mailbox!
  189.  
  190.           2)   Edit the file Announcer.commands in your TCPIP: directory to
  191.                include the programs you want Announcer to be able to run.
  192.  
  193.           3)   You must have the SPEAK: device mounted in order to have the
  194.                PAGE and PAGEMESSAGE functions work.
  195.  
  196.           4)   You must  have either  AmigaNOS or  a cron  type program run
  197.                Announcer periodically.  I suppose  you  could  have  it run
  198.                continuously and  putting a  wait delay in the AREXX program
  199.                but I chose not do do  it on  my system.   To  have AmigaNOS
  200.                execute Announcer  once every five minutes you would put the
  201.                following two lines in your nos-startup:
  202.  
  203.                     amiga interval 300
  204.                     amiga command rx TCPIP:Announcer.rx
  205.  
  206.           Using Announcer:
  207.  
  208.           1)   Announcer commands are placed on the  subject line  and sent
  209.                to  the   user  configured   in  the  mailfile  variable  in
  210.                Announcer.rx, it currently supports the following commands:
  211.  
  212.                PAGE {message}
  213.  
  214.                Uses the Amiga's narrator device (via  SPEAK:) to  "say" the
  215.                text on  the subject  line.   If the optional message is not
  216.                provided, the PAGE command  will use  the from  line to make
  217.                the announcement.
  218.  
  219.                PAGEMESSAGE
  220.  
  221.                Like PAGE  but uses  the body  of the  message to figure out
  222.                what to "say".  The text to be  spoken should  follow a line
  223.                which contains  only [START].   The  text will  be spoken up
  224.                until a line which contains only [END].
  225.  
  226.                PHONEHOME
  227.  
  228.                Uses the information in the configuration variables and your
  229.                modem  to  dial  a  phone  number  and  then hang up after a
  230.                variable amount of time.
  231.  
  232.                BEEPER
  233.  
  234.                Like PHONE  HOME except  it dials  the number  of a personal
  235.                pager or beeper and sends a message to display.
  236.  
  237.                                           4
  238. z
  239.  
  240.  
  241.  
  242.  
  243.           AmigaNOS Utilities                               December 5, 1993
  244.  
  245.  
  246.  
  247.                RUN program
  248.  
  249.                Checks Announcer.commands to see of "program" is in the list
  250.                of programs Announcer is permitted to run and  then executes
  251.                the  program.    Announcer  then  waits  for that program to
  252.                return control.
  253.  
  254.           2)   After processing successfully the commands in the mail file,
  255.                Announcer deletes  the file so that the commands will not be
  256.                run again.
  257.  
  258.           3)   Announcer keeps a  log  of  the  commands  it  processes and
  259.                reports  any   errors.     This  information  is  stored  in
  260.                TCPIP:Announcer.log and is created if it  does not  exist or
  261.                appended to if it does.
  262.  
  263.           The  possibilities  are  endless  for  a  program like Announcer,
  264.           hopefully these commands are a good start for ideas of  your own.
  265.           Got something  cool you  did with  it?   Let me know, I'd like to
  266.           hear from you.
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.                                           5
  297. c